​
インポート

import { useGetTransactionHistory } from '@0xsequence/hooks'

​
使い方

import { useGetTransactionHistory } from '@0xsequence/hooks'

function TransactionList() {
  const {
    data,
    fetchNextPage,
    hasNextPage,
    isLoading,
    isFetchingNextPage
  } = useGetTransactionHistory({
    chainId: 1,
    accountAddresses: ['0x123...'],
    // Optional filters:
    // contractAddress: '0x456...',
    // tokenId: '1'
  })

  if (isLoading) return <div>Loading...</div>

  return (
    <div>
      {data?.pages.map(page => 
        page.transactions.map(tx => (
          <div key={tx.txnHash}>
            Transaction: {tx.txnHash}
            Block: {tx.blockNumber}
            Time: {tx.timestamp}
          </div>
        ))
      )}
      
      {hasNextPage && (
        <button 
          onClick={() => fetchNextPage()}
          disabled={isFetchingNextPage}
        >
          {isFetchingNextPage ? 'Loading more...' : 'Load more'}
        </button>
      )}
    </div>
  )
}

​
返却型: UseGetTransactionHistoryReturnType

このフックはReact QueryのUseInfiniteQueryResultの全プロパティと、トランザクション履歴データを返します。詳細な構造は以下の通りです: 
type UseGetTransactionHistoryReturnType = UseInfiniteQueryResult<
  InfiniteData<GetTransactionHistoryReturn, unknown>,
  Error
>

​
プロパティ

​
data

InfiniteData<GetTransactionHistoryReturn> | undefined 複数ページを含むページネーションされたトランザクション履歴データ。各ページには以下が含まれます:
transactions
次のプロパティを持つトランザクションオブジェクトの配列:
  • txnHash: トランザクションハッシュ
  • blockNumber: トランザクションがマイニングされたブロック番号
  • blockHash: ブロックのハッシュ
  • chainId: トランザクションが発生したチェーンID
  • metaTxnID: メタトランザクションID（オプション）
  • transfers: トランザクションの転送情報配列（オプション）
  • timestamp: トランザクションのタイムスタンプ
ページ
ページネーション情報オブジェクト:
  • page: 次のページ番号
  • more: 次のページにさらに結果が存在するかどうか
  • pageSize: 1ページあたりの結果数

​
fetchNextPage

() => Promise<unknown> 次のページのトランザクションを読み込むための関数。

​
hasNextPage

boolean さらに読み込めるトランザクションがあるかどうかを示すブール値。

​
isLoading

boolean 初回データ取得時のローディング状態。

​
isFetching

boolean データ取得中（初回または追加取得時）のローディング状態。

​
isFetchingNextPage

boolean 次ページ取得時のローディング状態。

​
エラー

Error | null データ取得中に発生したエラー内容。

​
パラメータ

このフックは2つのパラメータを受け取ります：

​
引数: UseGetTransactionHistoryArgs

interface UseGetTransactionHistoryArgs {
  chainId: number
  accountAddresses: string[]
  contractAddress?: string
  tokenId?: string
  page?: {
    page: number
  }
}
パラメータ型説明
chainIdnumberトランザクションを取得するチェーンID
accountAddressesstring[]取引履歴を取得する対象のアドレス
contractAddressstring（オプション）コントラクトアドレスでトランザクションを絞り込み
tokenIdstring（オプション）トークンIDでトランザクションを絞り込み
pageobject（オプション）ページネーション設定

​
options: HooksOptions

interface HooksOptions {
  disabled?: boolean
  retry?: boolean
}
パラメータ型説明
disabledboolean（オプション）クエリの自動実行を無効にします
retryboolean（オプション）失敗したクエリを再試行するかどうか

​
補足

このフックは無限スクロール対応のトランザクション履歴取得メソッドを提供します。コントラクトアドレスやトークンIDでの絞り込みも可能なため、一般的なアカウント履歴や特定アセットの履歴表示に便利です。 このフックは内部的に@tanstack/react-queryを使用してデータ取得とキャッシュを行い、stale timeは30秒です。